Many hyperlinks are disabled.
Use anonymous login
to enable hyperlinks.
Overview
| Comment: | Implement Javascript-based keyboard navigation for web UI timelines. Shortcuts N and M focus the next or previous entry, and J and K toggle between /timeline and /info views for the focused entry. See comments in the committed Javascript file for more information. |
|---|---|
| Downloads: | Tarball | ZIP archive |
| Timelines: | family | ancestors | descendants | both | timeline-keyboard-navigation |
| Files: | files | file ages | folders |
| SHA3-256: |
b18c4256308c783e327e402e0e64c9d6 |
| User & Date: | florian 2022-07-29 06:36:00.000 |
Context
|
2022-07-29
| ||
| 10:24 | Omit the expiration date when creating the session cookie. ... (check-in: 540955bd36 user: florian tags: timeline-keyboard-navigation) | |
| 06:36 | Implement Javascript-based keyboard navigation for web UI timelines. Shortcuts N and M focus the next or previous entry, and J and K toggle between /timeline and /info views for the focused entry. See comments in the committed Javascript file for more information. ... (check-in: b18c425630 user: florian tags: timeline-keyboard-navigation) | |
|
2022-07-28
| ||
| 18:59 | Consolidated some minor code drift between pikchr's fiddle and fossil's pikchrshow. ... (check-in: 44cd975392 user: stephan tags: trunk) | |
Changes
Changes to src/default.css.
| ︙ | ︙ | |||
49 50 51 52 53 54 55 56 57 58 59 60 61 62 |
border-radius: 0;
border-width: 0;
}
tr.timelineCurrent td {
border-radius: 0;
border-width: 0;
}
span.timelineLeaf {
font-weight: bold;
}
span.timelineHistDsp {
font-weight: bold;
}
td.timelineTime {
| > > > > > > > > > | 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 |
border-radius: 0;
border-width: 0;
}
tr.timelineCurrent td {
border-radius: 0;
border-width: 0;
}
.timelineFocused {
background-image: url("data:image/svg+xml,%3Csvg \
xmlns='http://www.w3.org/2000/svg' viewBox='0,0,1,1'%3E%3Cpath \
style='fill:orange;opacity:0.5' d='M0,0h1v1h-1z'/%3E%3C/svg%3E") !important;
/*Note: IE requires explicit declarations for the next three properties.*/
background-position: top left;
background-repeat: repeat repeat;
background-size: 64px 64px;
}
span.timelineLeaf {
font-weight: bold;
}
span.timelineHistDsp {
font-weight: bold;
}
td.timelineTime {
|
| ︙ | ︙ |
Changes to src/graph.js.
| ︙ | ︙ | |||
796 797 798 799 800 801 802 |
var dataObj = document.getElementById("timeline-data-"+i);
if(!dataObj) break;
var txJson = dataObj.textContent || dataObj.innerText;
var tx = JSON.parse(txJson);
TimelineGraph(tx);
}
}());
| > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > | 796 797 798 799 800 801 802 803 804 805 806 807 808 809 810 811 812 813 814 815 816 817 818 819 820 821 822 823 824 825 826 827 828 829 830 831 832 833 834 835 836 837 838 839 840 841 842 843 844 845 846 847 848 849 850 851 852 853 854 855 856 857 858 859 860 861 862 863 864 865 866 867 868 869 870 871 872 873 874 875 876 877 878 879 880 881 882 883 884 885 886 887 888 889 890 891 892 893 894 895 896 897 898 899 900 901 902 903 904 905 906 907 908 909 910 911 912 913 914 915 916 917 918 919 920 921 922 923 924 925 926 927 928 929 930 931 932 933 934 935 936 937 938 939 940 941 942 943 944 945 946 947 948 949 950 951 952 953 954 955 956 |
var dataObj = document.getElementById("timeline-data-"+i);
if(!dataObj) break;
var txJson = dataObj.textContent || dataObj.innerText;
var tx = JSON.parse(txJson);
TimelineGraph(tx);
}
}());
/*
** Timeline keyboard navigation shortcuts:
**
** N - Select next (newer) entry.
** M - Select previous (older) entry.
** J - View timeline of selected entry.
** K - View details of selected entry.
** L - Disable keyboard navigation mode.
**
** When navigating to a page with a timeline display, such as /timeline, /info,
** or /finfo, keyboard navigation mode needs to be "activated" first, i.e. if no
** timeline entry is focused yet, pressing any of the listed keys (except L)
** sets the visual focus indicator to the highlighted or current (check-out)
** entry if available, or to the topmost entry otherwise. A session cookie[0] is
** used to direct pages loaded in the future to enable keyboard navigation mode
** and automatically set the focus indicator to the highlighted, current, or
** topmost entry. Pressing N and M on the /timeline page while the topmost or
** bottommost entry is focused loads the next or previous page if available,
** similar to the [↑ More] and [↓ More] links. Pressing L disables keyboard
** navigation, i.e. removes the focus indicator and deletes the session cookie.
** When navigating backwards or forwards in browser history, the focused entry
** is restored using a hidden[1] input field.
**
** [0]: The lifetime and values of cookies can be tracked on the /cookies page.
** A session cookie is preferred over other storage APIs because Fossil already
** requires cookies to be enabled for reasonable functionality, and it's more
** likely that other storage APIs are blocked by users for privacy reasons, for
** example.
** [1]: This feature only works with a normal (text) input field hidden by CSS
** styles, instead of a true hidden (by type) input field, so may cause side
** effects, for example with screen readers. Moreover, this feature currently
** only works with Chrome, but not with FF or IE.
**
** Ideas and TODOs:
**
** o Shortcut to select the topmost or bottommost entry, either by separate
** key, or with modifiers (SHIFT+N, SHIFT+M)?
** o Improve scrolling the focused element into view for browsers without the
** Element.scrollIntoViewIfNeeded() function, maybe with a Polyfill, or
** something similar to the scrollToSelected() function in this source file.
*/
(function(){
window.addEventListener('load',function(){
function focusDefaultId(){
var tn = document.querySelector('.timelineSelected .tl-nodemark') ||
document.querySelector('.timelineCurrent .tl-nodemark');
return tn ? tn.id : 'm1';
}
function focusNextId(id,dx){
var m = /^m(\d+)$/.exec(id);
return m!==null ? 'm' + (parseInt(m[1]) + dx) : null;
}
function focusRowinfoFromId(id){
for(var i=0; true; i++){
var td = document.getElementById('timeline-data-' + i);
if( !td ) break;
var ti = JSON.parse(td.textContent || td.innerText);
for( var k=0; k<ti.rowinfo.length; k++ ){
if( id=='m' + ti.rowinfo[k].id ) return {
'b': ti.baseUrl, 'h': ti.rowinfo[k].h
};
}
}
return null;
}
function focusVisualize(id,scroll){
var td = document.querySelector('.timelineFocused');
if( td ) td.classList.remove('timelineFocused');
if( !id ) return true;
var tn = document.getElementById(id);
if( tn ){
td = tn.parentElement.nextElementSibling;
if( td ) {
td.classList.add('timelineFocused');
if( scroll ){
if( td.scrollIntoViewIfNeeded ) td.scrollIntoViewIfNeeded();
else td.scrollIntoView(false);
}
return true;
}
}
return false;
}
var kf = document.getElementById('timeline-kbfocus');
if( !kf ){
kf = document.createElement('input');
kf.type = 'text';
kf.style = 'display:none;visibility:hidden;';
kf.id = 'timeline-kbfocus';
document.body.appendChild(kf);
}
document.addEventListener('keydown',function(evt){
var
kNEXT = 78 /* N */,
kPREV = 77 /* M */,
kTMLN = 74 /* J */,
kVIEW = 75 /* K */,
kDONE = 76 /* L */;
var key = evt.which || evt.keyCode;
if( evt.target.tagName=='INPUT' ) return;
if( evt.altKey || evt.ctrlKey || evt.shiftKey ) return;
var dx = 0;
if( key==kPREV ) dx++;
else if( key==kNEXT ) dx--;
else if( key!=kTMLN && key!=kVIEW && key!=kDONE ) return;
var kf = document.getElementById('timeline-kbfocus');
if( key==kDONE ){
kf.value = '';
focusVisualize(null,false);
document.cookie =
'fossil_timeline_kbnav=;expires=Thu, 01 Jan 1970 00:00:01 GMT;path=/';
return;
}
document.cookie = 'fossil_timeline_kbnav=1;expires=0;path=/';
var id = kf.value;
if( id && dx==0 ){
var ri = focusRowinfoFromId(id);
if( ri ){
var page = ( key==75/*K*/ ) ? '/info/' : '/timeline?c=';
var href = ri.b + page + ri.h;
if( href!=location.href.slice(-href.length) ){
location.href = href;
return;
}
}
}
else if ( id && dx!=0 ){
id = focusNextId(id,dx);
if( id && !document.getElementById(id) ){
var btn =
document.querySelector('.tl-button-' + ( dx>0 ? 'prev' : 'next' ));
if( btn ) btn.click();
return;
}
}
else if ( !id ) id = focusDefaultId();
kf.value = id;
focusVisualize(id,true);
}/*,true*/);
window.addEventListener('pageshow',function(evt){
var id;
var kf = document.getElementById('timeline-kbfocus');
if( kf ) id = kf.value;
if( !id || !focusVisualize(id,false) ){
if( document.cookie.match(/fossil_timeline_kbnav=1/) ){
id = focusDefaultId();
kf.value = id;
if( id ) focusVisualize(id,false);
}
}
},false);
},false);
}());
|
Changes to src/timeline.c.
| ︙ | ︙ | |||
2727 2728 2729 2730 2731 2732 2733 |
/* Report any errors. */
if( zError ){
@ <p class="generalError">%h(zError)</p>
}
if( zNewerButton ){
| | | | 2727 2728 2729 2730 2731 2732 2733 2734 2735 2736 2737 2738 2739 2740 2741 2742 2743 2744 2745 2746 2747 2748 |
/* Report any errors. */
if( zError ){
@ <p class="generalError">%h(zError)</p>
}
if( zNewerButton ){
@ %z(chref("button tl-button-next","%s",zNewerButton))%h(zNewerButtonLabel)\
@ ↑</a>
}
www_print_timeline(&q, tmFlags, zThisUser, zThisTag, zBrName,
selectedRid, secondaryRid, 0);
db_finalize(&q);
if( zOlderButton ){
@ %z(chref("button tl-button-prev","%s",zOlderButton))%h(zOlderButtonLabel)\
@ ↓</a>
}
document_emit_js(/*handles pikchrs rendered above*/);
style_finish_page();
}
/*
|
| ︙ | ︙ |