Method render

pkg/shell/topnav.tsx:96–317

()

    };

    render() {
        const Dialogs = this.context!;
        const {
            current_machine,
            current_manifest_item,
            current_manifest,
            current_frame,
        } = this.props.state;

        cockpit.assert(current_machine && current_manifest && current_manifest_item);

        const connected = current_machine.state === "connected";

        let docs: ManifestDocs[] = [];

        if (!this.superuser_connection || (this.superuser_connection.options.host !=
                                           current_machine.connection_string)) {
            if (this.superuser_connection) {
                this.superuser_connection.close();
                this.superuser_connection = null;
            }

            if (connected) {
                this.superuser_connection = cockpit.dbus(null, { bus: "internal", host: current_machine.connection_string });
                this.superuser = superuser_proxy(this.superuser_connection);
            }
        }

        // Check first whether we have docs in the "parent" section of
        // the manifest.
        const parent = (current_manifest.parent || {}) as ManifestParentSection;
        if (parent.docs)
            docs = parent.docs;
        else if (current_manifest_item.docs)
            docs = current_manifest_item.docs;

        const docItems = [];

        if (typeof this.state.osRelease?.DOCUMENTATION_URL == "string")
            docItems.push(<DropdownItem key="os-doc" to={this.state.osRelease.DOCUMENTATION_URL} target="blank" rel="noopener noreferrer" icon={<ExternalLinkAltIcon />}>
                {cockpit.format(_("$0 documentation"), this.state.osRelease.NAME)}
            </DropdownItem>);

        const shell_manifest = this.props.state.config.manifest;

        // global documentation for cockpit as a whole
        (shell_manifest.docs ?? []).forEach(doc => {
            docItems.push(<DropdownItem key={doc.label} to={doc.url} target="blank" rel="noopener noreferrer" icon={<ExternalLinkAltIcon />}>
                {doc.label}
            </DropdownItem>);
        });

        if (docs.length > 0)
            docItems.push(<Divider key="separator" />);

        docs.forEach(e => {
            docItems.push(<DropdownItem key={e.label} to={e.url} target="blank" rel="noopener noreferrer" icon={<ExternalLinkAltIcon />}>
                {_(e.label)}