Fossil SCM
Doc touchups in /chat. No code changes.
Commit
714142737069ca13064df7dfe6d983bb1b7b0c36d8fc9d043f5bd2bdec197e28
Parent
892dfd2b5510d62…
1 file changed
+9
-4
+9
-4
| --- src/fossil.page.chat.js | ||
| +++ src/fossil.page.chat.js | ||
| @@ -65,10 +65,14 @@ | ||
| 65 | 65 | /* This can inadvertently influence our flexbox layouts, so move |
| 66 | 66 | it out of the way. */ |
| 67 | 67 | D.append(document.body,dbg); |
| 68 | 68 | } |
| 69 | 69 | })(); |
| 70 | + /* Returns a list of DOM elements which "frame" the chat UI. These | |
| 71 | + elements are considered to _not_ be part of the chat UI and that | |
| 72 | + info is used for sizing the chat UI. In chat-only mode, these are | |
| 73 | + the elements that get hidden. */ | |
| 70 | 74 | const GetFramingElements = function() { |
| 71 | 75 | return document.querySelectorAll([ |
| 72 | 76 | "body > header", |
| 73 | 77 | "body > nav.mainmenu", |
| 74 | 78 | "body > footer", |
| @@ -711,11 +715,11 @@ | ||
| 711 | 715 | representations. It requires a server round-trip to collect the |
| 712 | 716 | plain-text form but caches it for subsequent toggles. |
| 713 | 717 | |
| 714 | 718 | Expects the ID of a currently-loaded message or a |
| 715 | 719 | message-widget DOM elment from which it can extract an id. |
| 716 | - This is an aync operation the first time it's passed a given | |
| 720 | + This is an async operation the first time it's passed a given | |
| 717 | 721 | message and synchronous on subsequent calls for that |
| 718 | 722 | message. It is a no-op if id does not resolve to a loaded |
| 719 | 723 | message. |
| 720 | 724 | */ |
| 721 | 725 | cs.toggleTextMode = function(id){ |
| @@ -783,11 +787,11 @@ | ||
| 783 | 787 | Chat.ajaxEnd(); |
| 784 | 788 | } |
| 785 | 789 | }); |
| 786 | 790 | return true; |
| 787 | 791 | }; |
| 788 | - | |
| 792 | + | |
| 789 | 793 | /** Given a .message-row element, this function returns whethe the |
| 790 | 794 | current user may, at least hypothetically, delete the message |
| 791 | 795 | globally. A user may always delete a local copy of a |
| 792 | 796 | post. The server may trump this, e.g. if the login has been |
| 793 | 797 | cancelled after this page was loaded. |
| @@ -1814,12 +1818,13 @@ | ||
| 1814 | 1818 | if(!Chat.e.activeUserListWrapper.classList.contains('collapsed')){ |
| 1815 | 1819 | Chat.animate(optAu.theList,'anim-flip-v'); |
| 1816 | 1820 | } |
| 1817 | 1821 | }, false); |
| 1818 | 1822 | }/*namedOptions.activeUsers additional setup*/ |
| 1819 | - /* Settings menu entries... the most frequently-needed ones "should" | |
| 1820 | - (arguably) be closer to the start of this list. */ | |
| 1823 | + /* Settings menu entries... they are presented in the order listed | |
| 1824 | + here, so the most frequently-needed ones "should" (arguably) be | |
| 1825 | + closer to the start of this list. */ | |
| 1821 | 1826 | /** |
| 1822 | 1827 | Settings ops structure: |
| 1823 | 1828 | |
| 1824 | 1829 | label: string for the UI |
| 1825 | 1830 | |
| 1826 | 1831 |
| --- src/fossil.page.chat.js | |
| +++ src/fossil.page.chat.js | |
| @@ -65,10 +65,14 @@ | |
| 65 | /* This can inadvertently influence our flexbox layouts, so move |
| 66 | it out of the way. */ |
| 67 | D.append(document.body,dbg); |
| 68 | } |
| 69 | })(); |
| 70 | const GetFramingElements = function() { |
| 71 | return document.querySelectorAll([ |
| 72 | "body > header", |
| 73 | "body > nav.mainmenu", |
| 74 | "body > footer", |
| @@ -711,11 +715,11 @@ | |
| 711 | representations. It requires a server round-trip to collect the |
| 712 | plain-text form but caches it for subsequent toggles. |
| 713 | |
| 714 | Expects the ID of a currently-loaded message or a |
| 715 | message-widget DOM elment from which it can extract an id. |
| 716 | This is an aync operation the first time it's passed a given |
| 717 | message and synchronous on subsequent calls for that |
| 718 | message. It is a no-op if id does not resolve to a loaded |
| 719 | message. |
| 720 | */ |
| 721 | cs.toggleTextMode = function(id){ |
| @@ -783,11 +787,11 @@ | |
| 783 | Chat.ajaxEnd(); |
| 784 | } |
| 785 | }); |
| 786 | return true; |
| 787 | }; |
| 788 | |
| 789 | /** Given a .message-row element, this function returns whethe the |
| 790 | current user may, at least hypothetically, delete the message |
| 791 | globally. A user may always delete a local copy of a |
| 792 | post. The server may trump this, e.g. if the login has been |
| 793 | cancelled after this page was loaded. |
| @@ -1814,12 +1818,13 @@ | |
| 1814 | if(!Chat.e.activeUserListWrapper.classList.contains('collapsed')){ |
| 1815 | Chat.animate(optAu.theList,'anim-flip-v'); |
| 1816 | } |
| 1817 | }, false); |
| 1818 | }/*namedOptions.activeUsers additional setup*/ |
| 1819 | /* Settings menu entries... the most frequently-needed ones "should" |
| 1820 | (arguably) be closer to the start of this list. */ |
| 1821 | /** |
| 1822 | Settings ops structure: |
| 1823 | |
| 1824 | label: string for the UI |
| 1825 | |
| 1826 |
| --- src/fossil.page.chat.js | |
| +++ src/fossil.page.chat.js | |
| @@ -65,10 +65,14 @@ | |
| 65 | /* This can inadvertently influence our flexbox layouts, so move |
| 66 | it out of the way. */ |
| 67 | D.append(document.body,dbg); |
| 68 | } |
| 69 | })(); |
| 70 | /* Returns a list of DOM elements which "frame" the chat UI. These |
| 71 | elements are considered to _not_ be part of the chat UI and that |
| 72 | info is used for sizing the chat UI. In chat-only mode, these are |
| 73 | the elements that get hidden. */ |
| 74 | const GetFramingElements = function() { |
| 75 | return document.querySelectorAll([ |
| 76 | "body > header", |
| 77 | "body > nav.mainmenu", |
| 78 | "body > footer", |
| @@ -711,11 +715,11 @@ | |
| 715 | representations. It requires a server round-trip to collect the |
| 716 | plain-text form but caches it for subsequent toggles. |
| 717 | |
| 718 | Expects the ID of a currently-loaded message or a |
| 719 | message-widget DOM elment from which it can extract an id. |
| 720 | This is an async operation the first time it's passed a given |
| 721 | message and synchronous on subsequent calls for that |
| 722 | message. It is a no-op if id does not resolve to a loaded |
| 723 | message. |
| 724 | */ |
| 725 | cs.toggleTextMode = function(id){ |
| @@ -783,11 +787,11 @@ | |
| 787 | Chat.ajaxEnd(); |
| 788 | } |
| 789 | }); |
| 790 | return true; |
| 791 | }; |
| 792 | |
| 793 | /** Given a .message-row element, this function returns whethe the |
| 794 | current user may, at least hypothetically, delete the message |
| 795 | globally. A user may always delete a local copy of a |
| 796 | post. The server may trump this, e.g. if the login has been |
| 797 | cancelled after this page was loaded. |
| @@ -1814,12 +1818,13 @@ | |
| 1818 | if(!Chat.e.activeUserListWrapper.classList.contains('collapsed')){ |
| 1819 | Chat.animate(optAu.theList,'anim-flip-v'); |
| 1820 | } |
| 1821 | }, false); |
| 1822 | }/*namedOptions.activeUsers additional setup*/ |
| 1823 | /* Settings menu entries... they are presented in the order listed |
| 1824 | here, so the most frequently-needed ones "should" (arguably) be |
| 1825 | closer to the start of this list. */ |
| 1826 | /** |
| 1827 | Settings ops structure: |
| 1828 | |
| 1829 | label: string for the UI |
| 1830 | |
| 1831 |