Display a person's profile picture in a circle
This sample applies styles to a parent
div element and a child
img element to show a person's profile picture in a circle.
The size can be easily adjusted by changing the default value of
32px for both the
height style attributes on the parent div.
You can also adjust the
border-radius value of the parent div to change it from a full circle (50%) to a rounded rectangle (< 50%). To get larger profile pictures you can change the
size=S portion of the URL to use either
size=L. See the table below for details on image size.
For best results, images should be square (S & M user profile pictures always are).
User Profile Picture sizes
The L size profile pictures maintain the ratio of the original photo which means they are not guaranteed to be square. Neither are they guaranteed to be 300px wide. The maximum width will be 300px but if the original image was smaller than that, then it will be the original size. Even the placeholder image for the L size is only 250x150.
Overall, however, the L size shouldn't be used inside columns not only because the ratio is not guaranteed, but because the default column width won't allow you to take up that much space.
@currentField.picturecan be used to retrieve a profile picture directly from a person column. However, size options are not available using that approach.
- This format can be applied to a Person column
|1.0||March 21, 2018||Initial release|
|1.1||August 20, 2018||Switched to Excel-style expression|
THIS CODE IS PROVIDED AS IS WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING ANY IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, OR NON-INFRINGEMENT.
This template is included in the Column Formatter webpart.
An additional version using Abstract Tree Syntax (AST) is also provided for environments where the Excel-style expressions are not supported.