8000 Make logo alt text configurable · Issue #3503 · squidfunk/mkdocs-material · GitHub
[go: up one dir, main page]

Skip to content

Make logo alt text configurable #3503

@bmustill-rose

Description

@bmustill-rose

Contribution guidelines

I want to suggest an idea and checked that ...

  • ... to my best knowledge, my idea wouldn't break something for other users
  • ... the documentation does not mention anything about my idea
  • ... there are no open or closed issues that are related to my idea

Description

Hi,

It would be useful if it were possible to configure alt text for the logo through the configuration file. I'm currently doing it manually by modifying the generated HTML files but have only been playing with the theme for a few days so may have missed something - apologies if so.

As a side note, anecdotally, aria-label is typically spoken in preference to the value of alt, so to make this work the aria-label for the anchor either needs to be set to the desired alt text or removed completely which is the approach I'd recommend FWIW.

Thanks.

Use Cases

  • Being able to specify alt text in the configuration file instead of having to add it manually would save time
  • Making it more of a feature of the theme may encourage greater adoption
  • Alt text is an important accessibility requirement for non-decorational images

Screenshots / Mockups

No response

Metadata

Metadata

Assignees

No one assigned

    Labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions

      0